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FACILITY: | DIRECTORY 

ABSTRACT: 

This module contains the definition for the display information 
block. This is the block that contains all of the information 
that may he displayed about a file. 

ENVIRONMENT: 


VAX/VMS operating system, unprivileged user mode utilities 


L. Mark Pilant CREATION DATE: , 4-Mar-1983 
MODIFiED BY: 
v03-007 LMPO211 i _ Pilant, 10-Mar-1984 12:47 


Modify the display block to more accurately track the 
information now obtained directly from the disk ACP. 


v03-006 LMP0182 Mark Pilant, 11-Jan-1984 12:38 
Add flags to ind cate what selection option was chosen. 
v03-005 DAsO 2 David Solomon 01-Aug-1983 


Max journal name went from 12 to 16. 
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v03-004 PASSRCR ae eat 29-Jul-1983 
RUA is now at) Y_RU. 

v03-003 LMP0119 t. Mark Pilant, 15-Jun-1983 9:26 
Add support for identifiers. 

v03-002 LMP0108 Mark Pilant, 28-Apr-1983 12:21 
Add support for bins Teureal names. 

v03-001 LMP0100 L. Mark Pilant, 14-Apr-1983 11:50 
Misc fixups. 
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module SDISPLAYDEF; 


/* Define the display information block. This block is filled with all of 

/* the information needed to create a full directory display on the selected 
/* file. With the exception of network files and indexed files, all of the 

/* information about the file is obtained from the disk ACP. Network files 

/* and indexed files are handled by RMS. Because the or eery path is the disk 
/* ACP, the pete | block should parallel the ODS-2 file header structurs as 
/* closely as possible. 


aggregate DISPLAYDEF structure prefix DIR_; 
4 The following describe the file specification 


STATUS Longword unsigned; /* File OPEN/QIO status 
FLAGS structure longword unsigned; /* Miscellaneous flags 
NOPRIV bitfield mask; /* No privilege to read info 
$QD bitfield mask; /* True if seq. device (magtapes) 
end FLAGS; 
OVI character dimension 16; /* Device ident. 
FNS byte unsigned; /* File name size 
FILE character dimension 256; /* File name buffer 
NODE byte unsigned; /* Filespec nodename Length 
DEV byte unsigned; /* Filespec ayuice Lengt 
DIR byte unsigned; /* Filespec d re ts 
VER byte unsigned; /* Filespec version lengt 
VERLIMIT word unsigned; /* File version Limit 
‘ ACLLENGTH Longword unsigned; /* Size of file's ACL 
; The following are obtained from the file header (SFHxDEF) 
FID structure fill; /* file ID 
FID_NUM word unsigned; /* file number 
FID_SEQ word unsigned; /* file sequence number 
tea word unsigned; /* relative volume number 
TTR structure; /* file record attributes 
RTYPE structure byte unsigned; /* record type 
RTYPE bitfield Length 4; /* record type subfield 
constant ( 
UNDEF INED /* undefined record type 
» FIX > /* fixed record a 
- VARIABLE /* variable Lengt 
- VEC /* variable + fixed control 
» STREAM /* RMS-11 (DEC traditional) stream format 
» STREAMLF /* LF-terminated stream format 
STREAMCR /* CR-terminated stream format 
} equals 0 increment 1 prefix DIR_ tag C; 
neo tfield length 4; /* file organization 
constan 
SEQUENTIAL /* sequential organization 
- RELATIVE /* relative organization 


« INDEXED /* indexed organization 
- DIRECT /* direct organization 
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record attributes 

Fortran carriage control 
implied carriage control 
print file carriage control 
no spanned records 


record size in bytes 
highest allocated VBN 
high order word 

low order word 


end of file VBN 
high order word 
low order word 


first free arte in EFBLK 
bucket size in blocks 


size in bytes of fixed length control for VFC records 


maximum record size in bytes 
default extend quantity 
global buffer count 

spare 

default version Limit for directory file 


file characteristics 

reserve 

file is not to be backed up 

file may be write-back cached 
verify all read operations 

yorsty all write operations 

keep file as contiguous as possible 
file is deaccess locked 

file is contiguous 


ile contains bad blocks 

le is marked for delete 

le space is not to be charged | 
ase file contents before deletion 


le owner U 
C member number 
IC group number 


i 
i 
r 
gest priv theges access mode 
I 


cc-=- 8«-—--— 


file protection 


file is accessible only in recovery unit 
enable recovery unit journal 
enable before image journal 


DISPLYDEF .SOL;1 
atved equals 0 increment 1 prefix DIR_ tag C; 
RATTRIB structure byte unsigned; /* 
FORTRANCC bitfield mask; /* 
pL TERE’ bistield mask; /* 
PRINTCC bitfield mask; /* 
NOSPAN bitfield mask; /* 
end RATTRIB; 
RSIZE word unsigned; /* 
HIBLK structure at eek unsigned; /* 
HIBLKH word unsigned; /* 
HIBLKL word unsigned; /* 
end HIBLK; 
EFBLK structure oy po unsigned; Je 
EFBLKH word unsigned; /* 
EFBLKL word unsigned; /* 
end Fret ; 
FFBYTE word une Sened: /* 
BKTSIZE byte unsigned; /* 
VFCSIZE byte unsigned; /* 
MAXREC word unsigned; /* 
DEFEXT word unsigned; /* 
GBC word unsigned; /* 
FILL_.1 word dimension 4 fill; /* 
VERSIONS word unsigned; /* 
end RECATTR; 
FILECHAR structure lonpyore unsigned; /* 
tfield fill; /* 
C bitfield mask /* 
WRITEBACK bitfield mask; /* 
EADCHECK bitfield mask; /* 
WRITCHECK bitfield mask; /* 
CONTIGS bitfield mask; /* 
LOCKED bitfield mask; /* 
petts bitfield mask; /* 
FILL_2 bitfield Length 3 fill; /* 
BADACL bitfield mask; /* 
SPOOL bitfield mask; /* 
DIRECTORY bitfield mask; /* 
BADBLOCK bitfield mask; /* 
MARK bitfield mask; /* 
NOCHARGE bitfield mask; /* 
ERASE bitfield mask; /* 
end FILECHAR; 
ACC _ MODE byte unsigned; /* 
FILEOWNER structure longword unsigned; /* 
UICMEMBER word unsigned; /* 
UICGROUP word unsigned; /* 
end UIC; 
FILEPROT word unsigned: /e 
JOURNAL structure word unsigned; 
ONLY_RU bitfield mask; /* 
RUJNC bitfield mask; /* 
BIJNL bitfield mask; /* 
ALIJNL bitfield mask; /* 
ATJNL bitfield mask; /* 


enable after {nage ournal 
enable audit trail journal 
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phe RU bitfield mask; /* 
HIGHWATER énqword unsigned; /* 
CLASS_PROT tok hohe /* 
LL Reet dimension 20 fill; /* 

end CLAS 


file is never accessible in recovery unit 


high-water mark in file 
security classifi ation mask 
see structure in SCLSDEF 


The following are donload from the file header ident area (SFIXxDEF) 


REVISION word unsigned; /* 
eons structure quadword unsigned; /* 
CDTO Longword unsigned; 
ond CReDATE ee” unsigned: 
REVDATE structure oy rat A unsigned; /* 
RDTO Longword uns 
RDT4 senguere unsigned: 
end REVDATE; 
EXPDATE structure Quadword unsigned; /* 
DTO Longword unsigned; 
EDTS ronguoré unsigned; 
end EXPDATE; 
BAKDATE structure quadword unsigned; /* 
BDTO Longword unsigned; 
BDT4 Longword unsigned: 
end BAKDATE; 


revision number (binary) 
Creation date 


Revision date 


Expiration date 


Backup date 


{ 
: The following are obtained from RMS for indexed or relative files. 


MRN Longword unsigned; /* 
NOAREAS ayes unsigned: /* 
NOKEYS byte unsi /* 


PVN word unsigned; /* 
{ The following are obtained from the file's ACL. 


JNL1 A wt fill; 
Al_JNLNAME character dimension 17; /* 
INCe structure fill; 
1.5 E byte uns ign 
I-NARE aracter or Bees 16; 


NL1; 
JNL3 union fill; 
Bl_JNLNAME character dimension 17; /* 
‘ania struct ure fill; 
Beane orte uns ign 
character Oe ies 16; 
end omer 


end JNL3; 
JNLS union fill; 
AT_JNLNAME character dimension 17; /e 
JnC6 structure Fatt | 
AT_SIZE byte 
AT_NAME ¢ A nt a a 16; 
end into: 6; 


Maximum record number 
Number of areas in idx files 
Number of keys (ISAM only) 
Prologue version number 


Al journal name 


BI journal name 


AT journal name 
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end JNLS; 


constant “LENGTH” equals . pref 
constant “LENGTH” cquels e ore? 


end DISPLAYDEF ; 
end_module SDISPLAYDEF; 
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module SDIRQUALDEF ; 
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